<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8">
<!-- qdoctests-outputfromqdocfiles.qdoc -->
  <title>Testing QDoc output from .qdoc files | OutputFromQDocFiles</title>
</head>
<body>
<li id="buildversion">OutputFromQDocFiles - A test project for QDoc build artifacts</li>
  <link rel="next" href="qdoctests-qdocfileoutput-linking.html" />
<p class="naviNextPrevious headerNavi">
<a class="nextPage" href="qdoctests-qdocfileoutput-linking.html">QDoc Linking Test</a>
</p><p/>
<div class="sidebar">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#supported-file-types">Supported file types</a></li>
<li class="level1"><a href="#further-information">Further information</a></li>
<li class="level1"><a href="#linking">Linking</a></li>
</ul>
</div>
<div class="sidebar-content" id="sidebar-content"></div></div>
<h1 class="title">Testing QDoc output from .qdoc files</h1>
<span class="subtitle"></span>
<!-- $$$qdoctests-qdocfileoutput.html-description -->
<div class="descr"> <a name="details"></a>
<p>QDoc generates documentation for software projects. It does this by extracting <i>QDoc comments</i> from project source files. QDoc comments are signified by a C-style-like comment tag followed by an exclamation point, like this: <code>/*!</code> <code>This text is contained within QDoc comment tags.</code> <code>*/</code>.</p>
<a name="supported-file-types"></a>
<h2 id="supported-file-types">Supported file types</h2>
<p>QDoc parses <code>.cpp</code> and <code>.qdoc</code> files. It does extract comments from header (<code>.h</code>) files.</p>
<a name="further-information"></a>
<h2 id="further-information">Further information</h2>
<p>This test document is written with the purpose of testing the output QDoc generates when parsing <code>.qdoc</code> files. It is fairly simple and makes use of a limited subset of QDoc's command. Those commands are:</p>
<ul>
<li><code>\page</code></li>
<li><code>\title</code></li>
<li><code>\brief</code></li>
<li><code>\e</code> (for emphasizing &quot;QDoc comments&quot;)</li>
<li><code>\c</code> (for multiple monospace-formatted entries)</li>
<li><code>\section1</code></li>
<li><code>\list</code></li>
<li><code>\li</code></li>
<li><code>\endlist</code></li>
</ul>
<a name="linking"></a>
<h2 id="linking">Linking</h2>
<p>There are multiple ways to create hyperlinks to other topics:</p>
<ul>
<li><a href="qdoctests-qdocfileoutput-linking.html">Linking to a page title</a></li>
<li><a href="qdoctests-qdocfileoutput-linking.html#link-targets">Linking to a section title</a></li>
<li><a href="qdoctests-qdocfileoutput-linking.html#link-test-target">Linking using a \target string</a></li>
<li><a href="qdoctests-qdocfileoutput-linking.html">Linking using a \keyword string</a></li>
</ul>
</div>
<!-- @@@qdoctests-qdocfileoutput.html -->
<p class="naviNextPrevious footerNavi">
<a class="nextPage" href="qdoctests-qdocfileoutput-linking.html">QDoc Linking Test</a>
</p>
</body>
</html>
